﻿<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3c.org/TR/1999/REC-html401-19991224/loose.dtd">
<HTML><HEAD><TITLE>SoundPlay</TITLE>
<META http-equiv=Content-Type content="text/html; charset=UTF-8"><LINK 
href="../css/commands.css" type=text/css rel=stylesheet><LINK media=print 
href="../css/print.css" type=text/css rel=stylesheet>
<META content="MSHTML 6.00.6000.16674" name=GENERATOR></HEAD>
<BODY>
<H1>SoundPlay</H1>


<P>播放一个音频、视频或者其他支持的文件类型。</P>
<P class=CommandSyntax>SoundPlay, Filename [, wait] </P>
<h3>参数 </h3>
<TABLE borderColor=#c0c0c0 cellSpacing=0 cellPadding=3 width="100%" border=1>
  <TBODY>
  <TR>
    <TD>Filename</TD>
    <TD>
      <P>要被播放的文件名称，如果绝对路径未指定将假设在 <A 
      href="../Variables.htm#WorkingDir">%A_WorkingDir%</A> 。</P>
      <P>要发出标准的系统声音，像下面显示的那样在一个星号后面指定一个数字。注意：<EM>wait</EM> 参数在此模式中无效。<BR>*-1: 
      简单的哔哔声。如果声卡不可用，此声音将使用主板扬声器来生成。<BR>*16: 手型(停止/错误声)<BR>*32: 问号声<BR>*48: 
      感叹声<BR>*64: 星号(消息声)</P></TD></TR>
  <TR>
    <TD width="15%">wait</TD>
    <TD width="85%">
      <P>如果省略，当文件在播放时脚本的 <A href="../misc/Threads.htm">current thread</A>(当前线程) 
      将移动到下一个命令。要避免这样，指定此参数为 1 或者是单词 WAIT ，这能使当前线程在继续前等待文件播放结束。甚至在等待时，新的 <A 
      href="../misc/Threads.htm">threads</A> 也能通过 <A 
      href="../Hotkeys.htm">hotkey</A>&nbsp;、<A href="Menu.htm">custom menu 
      item</A>&nbsp;或者 <A href="SetTimer.htm">timer</A>&nbsp;来启动。</P>
      <P>已知限制：如果省略 WAIT 
      参数，操作系统可能会认为播放的文件“在使用中”直到脚本关闭或者直到另一个文件被播放(甚至一个不存在的文件)。</P></TD></TR></TBODY></TABLE>
<h3>ErrorLevel</h3>
<P>如果遇到一个问题 <A href="../misc/ErrorLevel.htm">ErrorLevel</A> 设为 1 ，否则是&nbsp; 0 
。</P>
<h3>注意</h3>
<P>所有的 Windows 操作系统都能够播放 .wav 文件。不过，如果操作系统没有安装正确的编解码器或者功能，那么其他文件(.mp3 、.avi 等) 
可能无法播放。</P>
<P>如果一个文件正在播放并且当前脚本播放了第二个文件，那么第一个文件将停止播放以便第二个文件能播放。在一些操作系统上，即使当一个完全独立的脚本播放一个新的文件时，特定的文件类型也可能停止播放。</P>
<P>要停止一个当前播放的文件，像这个例子一样，在一个不存在的文件名称上使用 SoundPlay：SoundPlay, Nonexistent.avi</P>
<P>如果脚本退出，任何由它启动的当前正在播放的文件将会停止。</P>
<h3>相关命令</h3>
<P><A href="SoundBeep.htm">SoundBeep</A>, <A href="SoundGet.htm">SoundGet</A>, 
<A href="SoundSet.htm">SoundSet</A>, <A 
href="SoundGetWaveVolume.htm">SoundGetWaveVolume</A>, <A 
href="SoundSetWaveVolume.htm">SoundSetWaveVolume</A>, <A 
href="MsgBox.htm">MsgBox</A>, <A href="../misc/Threads.htm">Threads</A></P>
<h3>示例</h3><PRE class=NoIndent>SoundPlay, %A_WinDir%\Media\ding.wav</PRE>
</BODY></HTML>
